home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / misc / hamware / tncterm.doc < prev    next >
Text File  |  1994-11-04  |  45KB  |  940 lines

  1.                                    Chapter 1
  2.  
  3.                                   Introduction
  4.  
  5.      1.1  What is TNCTERM?
  6.  
  7.      TNCTERM is a complete TNC operating environment.  It consists of a set
  8.      of programs that provide the amateur radio operator with automated ter-
  9.      minal node control, logging, and message generation.  TNC.EXE, the pri-
  10.      mary TNC program, is a 'C' program which provides the user with a menu
  11.      oriented interface to the TNC.  It also has links to the other programs
  12.      which provide the operator with a full set of data base functions.
  13.  
  14.           . TNCED.EXE     - full screen editor
  15.  
  16.           . LOGBOOK.EXE   - ISAM based logbook database program
  17.  
  18.           . COUNTRIES.EXE - callsign/country lookup program with great circle
  19.                             distance & bearing computation
  20.  
  21.           . HAMGRAM.EXE   - NTS message generation and database
  22.  
  23.      1.2 Flexibility
  24.  
  25.        -  TNC may be configured to function with either the COM1 or COM2
  26.           serial ports at speeds from 300 to 9600 baud.
  27.  
  28.        -  Fully configurable color selection, terminal screen layout, and
  29.           file location are just a few of the adjustable parameters.
  30.  
  31.        -  Provides all of the common file handling functions of the popular
  32.           communications programs including ASCII file transmit and re-
  33.           ceive, screen buffer captures,
  34.  
  35.        -  Supports all modes, CW, AMTOR, RTTY, PACKET (VHF/HF).
  36.  
  37.      1.3 Ease of Use
  38.  
  39.        -  Pull down menus provide complete access to all internal and
  40.           external functions.
  41.  
  42.        -  Fully scrollable receive buffer of 800 lines.  Receive buffer
  43.           may be written to disk file of users choice.
  44.  
  45.        -  Receive function operates independent of transmit buffer.  Create
  46.           outgoing text while the other op' is transmitting.
  47.  
  48.        -  Removes operator from the cryptic TNC protocol language.  All
  49.           change of mode transmit/receive, etc are handled by TNCTERM.
  50.           Operator makes selections by pulldown menu selection.
  51.  
  52.      1.4 Distribution of TNCTERM
  53.  
  54.      TNCTERM is commercial software.  Clermont Computer Consultants retains
  55.      sole distibution and resale rights to all programs contained on the dis-
  56.      tribution disk including:
  57.  
  58.               TNC.EXE
  59.               TNCED.EXE
  60.               TNCEDINS.EXE
  61.               HAMLOG.EXE
  62.               HAMGRAM.EXE
  63.               COUNTRY.EXE.
  64.  
  65.      1.5  The most recent version of this software is always available from
  66.      the author at:
  67.  
  68.                Clermont Computer Consultants
  69.                122 N. Ravenwood Drive
  70.                Cape May Court House, NJ  08210
  71.                (609) 624 0076.
  72.  
  73.           The cost for the software on either 5 1/4" or 3 1/2" diskette is
  74.      $35.00.  Please send check or money order drawn on U.S. dollars with
  75.      your order.
  76.  
  77.      1.6  Disclaimer
  78.  
  79.      W1HKJ, David Freese and Clermont Computer Consultants make no  warran-
  80.      ty, expressed or implied, concerning this program's merchantability or
  81.      fitness for any particular use.  In no event is David Freese or  Cler-
  82.      mont Computer Consultants liable to you for any damages resulting from
  83.      your use of the program.
  84.                                    Chapter 2
  85.  
  86.                           Getting Started with TNCTERM
  87.  
  88.      2.1 System Requirements
  89.  
  90.      TNCTERM has the following minimal requirements:
  91.  
  92.        -  IBM  PC, XT, AT, PS-2 or compatible with at least 320 K bytes  of
  93.           memory.
  94.  
  95.        -  DOS 2.0 or later
  96.  
  97.        -  Floppy disk drive, 360K, 1.2M, 720K, 1.44M, or a hard drive.
  98.  
  99.        -  Either COM1 or COM2 port available for serial communications.
  100.  
  101.        -  the  Kantronics All Mode Terminal Node Controller, KAM or
  102.           the  MFJ Multi-Mode Data Controller, MFJ-1278 or
  103.           the  PK232
  104.  
  105.      2.2 TNCTERM installation
  106.  
  107.      TNCTERM is distributed with the following files:
  108.  
  109.           TNC.EXE        Executable file which directly interfaces to the
  110.                          Terminal Node Controller.
  111.  
  112.           TNCTERM.KAM    Configuration file for using TNCTERM with the
  113.                          Kantronics All Mode TNC.
  114.  
  115.           TNCTERM.MFJ    Configuration file for using TNCTERM with the
  116.                          MFJ-1278 Multi-Mode Data Controller
  117.  
  118.           TNCTERM.AEA    Configuration file for using TNCTERM with the
  119.                          AEA PK-232 TNC.
  120.  
  121.           COUNTRY.EXE    Stand alone prefix/country lookup program
  122.  
  123.           COUNTRY.LST    ASCII text file containing the Prefix/Country list
  124.                          as found in the 1991 Call Book.  This file is used
  125.                          by COUNTRY.EXE.
  126.  
  127.           TNCED.EXE      Full screen editor, colors and keyboard reconfig-
  128.                          urable.  Edits file up to maximum of available
  129.                          computer memory.
  130.  
  131.           TNCEDINS.EXE   Installation program for TNCED.EXE.  Allows color,
  132.                          and keyboard reconfiguration.
  133.  
  134.           LOGBOOK.EXE    ISAM based database for keeping amateur radio log.
  135.                          Includes both date and callsign indexing of the
  136.                          database.
  137.  
  138.           HAMGRAM.EXE    dBase-III compatible database of National Traffic
  139.                          System messages.  Builds NTS messages with proper
  140.                          pre and postambles, and word count.
  141.  
  142.      2.3  First-time Setup of TNCTERM
  143.  
  144.      HARD DISK   I suggest you create a directory called \HAM.  Copy all of
  145.      the files to this directory and include the directory name in your
  146.      path definition.
  147.  
  148.      FLOPPY DISK Simply make a working copy of the distribution disk to use
  149.      as a working disk.  If you have a two floppy drive system you may
  150.      modify the configuration file to direct all log and other data files
  151.      to the second disk.  See the configuration file specification below.
  152.  
  153.      2.3.1 CONFIG.SYS - no changes to your config.sys file are necessary.
  154.  
  155.      2.3.2 AUTOEXEC.BAT - Add the directory name of your TNCTERM files to
  156.      your path statement.
  157.  
  158.      2.3.3  Before  executing the program, you should prepare the TNCTERM.CFG
  159.      file for your specific installation.  Three preconfigured files are
  160.      included with the distribution disk, TNCTERM.KAM, TNCTERM.MFJ,
  161.      TNCTERM.AEA.  Copy the appropriate file to a new file called TNCTERM.CFG.
  162.  
  163.      2.3.4  The TNCTERM.DEF file contains several user configurable parameters
  164.      and some others that you should only change if you need to adapt the
  165.      program to some other TNC.  A line which begins with a semicolon is
  166.      ignored by TNC.EXE and can be used for comments in the configuration file.
  167.  
  168.      Each configurable parameter is specified by a line such as:
  169.  
  170.           TNCPORT=1
  171.  
  172.      The TNC.EXE program will search for the string 'TNCPORT=' and expects
  173.      to find the parameter immediately following the equals sign.  Do not put
  174.      spaces around the '=' sign.
  175.  
  176.      RS-232 serial port definitions:
  177.  
  178.           TNCPORT=1                1 = COM1, 2 = COM2
  179.           TNCPARITY=0              0 = NONE, 1 = ODD, 2 = EVEN
  180.           TNCSTOPBITS=1            1 or 2 STOPBITS
  181.           TNCWORDLEN=8             7 or 8 bit WORDLEN
  182.           TNCBAUD=9600             300,600,1200,2400,4800,9600
  183.  
  184.      Child process definitions:
  185.  
  186.           TNCLOGPROG=hamlog.exe
  187.           TNCLOGBOOK=hamlog
  188.           TNCEDIT=tnced.exe
  189.           TNCCOUNTRIES=country.exe
  190.           TNCCOUNTRYLIST=country.lst
  191.           TNCNTSPROG=hamgram.exe
  192.  
  193.      If you have a logbook program that you prefer to use, it may be specified
  194.      on the TNCLOGPROG= line.  If that program expects to be passed a parameter
  195.      it may be specified on the TNCLOGBOOK= line.  If no drive or path is given
  196.      then TNCTERM will expect to find them in the default directory.
  197.  
  198.      2.4 Initial Set Up of TNCTERM.
  199.  
  200.      Turn the TNC and your computer off.  Connect the two using the config-
  201.      ured  communications  port.  Connect the TNC to your  HF/VHF  gear  in
  202.      accordance  with  the TNC instruction manual.  I  recommend  beginning
  203.      with  the VHF/UHF equipment.
  204.  
  205.      Turn your computer on and boot it using DOS 3.0 or later.
  206.  
  207.      Change to the drive and directory containing TNCTERM programs and execute
  208.      TNCTERM.EXE.
  209.  
  210.      2.5 FIRST TIME USE OF KAM OR MFJ-1278
  211.  
  212.      Turn  the  TNC on and wait for a readable message to  appear  on  your
  213.      screen.  Immediately press the asterisk '*'.  The TNC will now be  set
  214.      to the same baud as the computer.  Follow the instructions
  215.      for your TNC to make this a permanent setup.
  216.  
  217.      2.5.1 TIME ZONE Environment Variable
  218.  
  219.      Enter the following either in your AUTOEXEC.BAT file or from the DOS
  220.      command prompt:
  221.  
  222.            SET TIMEZONE=4      ( a range of -11 to +11 allowed)
  223.  
  224.      If the TIMEZONE variable is missing from the environment or its value is
  225.      0 then no correction is made to GMT.
  226.  
  227.  
  228.                                    Chapter 3
  229.  
  230.                          Main Display & Operating Modes
  231.  
  232.      3.1  Main Display
  233.  
  234.      3.1.1   The  main  display consists of a transmit  window,  a  receive
  235.      window and a status bar.
  236.  
  237.           ┌──────────────────────────────────────────────────────────┐
  238.           │                                                          │
  239.           │                                                          │
  240.           │                                                          │
  241.           │                     Receive window                       │
  242.           │                                                          │
  243.           │                                                          │
  244.           │                                                          │
  245.           │                                                          │
  246.           ├──────────────────────────────────────────────────────────┤
  247.           │                        Status Bar                        │
  248.           ├──────────────────────────────────────────────────────────┤
  249.           │                                                          │
  250.           │                                                          │
  251.           │                     Transmit Window                      │
  252.           │                                                          │
  253.           │                                                          │
  254.           └──────────────────────────────────────────────────────────┘
  255.  
  256.      3.1.2   Receive Window - This multi-line window will contain the  most
  257.      recently  received  data.  It contains the most recently received
  258.      text in an 800 line text buffer.
  259.  
  260.      3.1.3   Status Bar - The right hand portion of the status bar shows the
  261.      present date time properly converted to Greenwich Mean Time.  The
  262.      left hand portion of the status bar indicates whether the capture or
  263.      receive file mode is active, and if a text file is being transmitted.
  264.  
  265.      3.1.4  Transmit Window - The transmit window is a multi-line  scrolla-
  266.      ble  area for entering transmitted text.  When transmit data is  taken
  267.      from  external files it is  shown sequentially in the area.
  268.  
  269.      3.1.5  Pull Down Menus -  All program operations are available through
  270.      a pull down menu system.  The menu system is activated by pressing the
  271.      F10 key.  Menu selection is accomplished by use of the arrow and Enter
  272.      keys.  Some menu selections will open submenus for further selection.
  273.  
  274.      3.2  Operating Modes
  275.  
  276.      3.2.1   TNCTERM  properly interfaces with the TNC in  the  CW,  AMTOR,
  277.      RTTY, ASCII, HF-PACKET, and VHF-PACKET operating modes.  It provides a
  278.      layer of isolation between the operator and the TNC control  language.
  279.      This isolation is particularly beneficial in CW, AMTOR, ASCII and RTTY
  280.      modes as it allows the operator to concentrate on the QSO and not  the
  281.      control  language.   It is frustrating to have to look  up  a  desired
  282.      control  language sequence in the middle of a QSO.  Mode selection  is
  283.      make on the MODE pull down menu.
  284.                                    Chapter 4
  285.  
  286.                                   Menu System
  287.  
  288.      4.1  A pull-down / pop-up menu system is used to access all function
  289.      of the program.  In addition, certain functions can be quickly brought
  290.      up by alternate hot keys.  On the menu system these are shown by the
  291.      <K> symbol where K is the access character.
  292.  
  293.      4.2  The menu system is activated by pressing function key <F10>.
  294.      The top line of the display contains the names of each menu section
  295.      and the leftmost menu will be active.  The screen appears as:
  296.  
  297.      Modes  Files  Buffers  Accessory  Setup  DosApp
  298.      ┌──────┐
  299.      │Ascii │
  300.      │Baudot│
  301.      │Cw    │
  302.      │Fax   │
  303.      │Packet│
  304.      └──────┘
  305.  
  306.      4.3  You can move between vertical menu items by pressing the bold
  307.      character or by using the up and down arrow keys.  Movement between
  308.      horizontal menus is obtained by use of the left and right arrow keys
  309.      only.  The selected item is indicated by reverse field.  Press
  310.      <ENTER> to activate that function.
  311.  
  312.      4.4  For example, to activate morse code, Press <C> or move the reverse
  313.      field indicator using the up/down arrow keys.  Press <ENTER>.  A new
  314.      pull down menu will appear next to the Cw entry, indicating that further
  315.      selection is required:
  316.  
  317.      Modes  Files  Buffers  Accessory  Setup  DosApp
  318.      ┌──────┐
  319.      │Ascii │
  320.      │Baudot│┌───────┐
  321.      │Cw    ││HF     │
  322.      │Fax   ││VHF(mcw│
  323.      │Packet│└───────┘
  324.      └──────┘
  325.  
  326.      4.5  The other menus are:
  327.  
  328.      Modes  Files  Buffers  Accessory  Setup  DosApp
  329.             ┌───────────┐
  330.             │Capture <C>│
  331.             │Receive <R>│
  332.             │Transmit   │
  333.             │ErasRcvBuff│
  334.             │SaveRcvBuff│
  335.             │ViewRcvBuff│
  336.             └───────────┘
  337.  
  338.      Modes  Files  Buffers  Accessory  Setup  DosApp
  339.                    ┌─────────┐
  340.                    │LoadBuffr│
  341.                    │ModBuffer│
  342.                    │XmtBuffer│
  343.                    └─────────┘
  344.  
  345.      Modes  Files  Buffers  Accessory  Setup  DosApp
  346.                             ┌───────────┐
  347.                             │Country    │
  348.                             │LogBook <L>│
  349.                             │NTSmsgs    │
  350.                             └───────────┘
  351.  
  352.      Modes  Files  Buffers  Accessory  Setup  DosApp
  353.                                        ┌─────────┐
  354.                                        │Baud     │
  355.                                        │cwWPM    │
  356.                                        │Date/Time│
  357.                                        │─────────│
  358.                                        │Colors   │
  359.                                        │LoadClrs │
  360.                                        │SaveClrs │
  361.                                        └─────────┘
  362.  
  363.      Modes  Files  Buffers  Accessory  Setup  DosApp
  364.                                               ┌─────────┐
  365.                                               │Dos      │
  366.                                               │Editor   │
  367.                                               │eXit  <X>│
  368.                                               └─────────┘
  369.                                    Chapter 5
  370.  
  371.                                 Transmit Buffers
  372.  
  373.      5.1   Ten transmit buffers are available for quick insertion into  the
  374.      transmit data stream.  These buffers are read from and written  to the
  375.      file TNCTERM.BFR unless otherwise specified.  Transmit buffer mainten-
  376.      ance is found under the Buffer pull down menu.
  377.  
  378.      5.2   Transmitting  a buffer - You may select a transmit buffer by one
  379.      of two methods.
  380.  
  381.           (1) Using the pull down menus, select XmtBuffer.  The entire set
  382.               of 10 buffers will be displayed.  Using the UP and DWN arrow
  383.               keys, select the desired buffer and press ENTER.  If you change
  384.               your mind you may abort the selection by pressing ESC.
  385.  
  386.           (2) Select a transmit buffer by  using  the alternate key combined
  387.               with a number key.  For example: buffer  number 3 is inserted
  388.               into the transmit stream by pressing alt<3>.
  389.  
  390.      5.3  Viewing and Modifying Buffers - Access the buffers by selecting
  391.      ModBuffer on the Buffer pull down menu.  Specify the name of the buffer
  392.      file.  The default editor will be called with the specified file.  Change
  393.      the text as desired and exit the editor using <alt>X (if using TNCED).
  394.      The ten buffers will be updated on return to TNC.
  395.  
  396.      5.4 Loading a new set of buffers.  Select the LoadBuffer function on the
  397.      Buffer pull down menu.  Specify the name of the desired buffer file.  If
  398.      the file is found the ten buffers will be overwritten with the file data.
  399.  
  400.      5.5  Modifying the buffer file directly - Each buffer file is a simple
  401.      text  file  containing ten lines where each line does  not  exceed  80
  402.      characters.   You may modify the file using a text editor.  Make  sure
  403.      that the editor treats the file as a non-document.
  404.  
  405.  
  406.  
  407.  
  408.      NOTE:  FILE SELECTION
  409.  
  410.      At any file name prompt you may enter a sequence of wildcards in the
  411.      file name.  For example:
  412.  
  413.           *.TXT       ..\TEXT\BUFFERS.?91      c:\WP\BUFFER?.WP
  414.  
  415.      When a wildcard is entered a pick list will be displayed showing all
  416.      matching file names.  The actual list may be longer than the display
  417.      so you can scroll past the end of the display.  Move to the desired
  418.      file using the UP and DOWN arrow keys and select it by pressing <ENTER>.
  419.      If the file is not found, press <ESC> to return to the file name
  420.      prompt.  If only one matching file is found, its name will be entered
  421.      into the file name prompt and no pick list will be displayed.
  422.                                    Chapter 6
  423.  
  424.                                File Transmission
  425.  
  426.      6.1  Plaintext (ASCII) files can be transmitted in any mode.  This mode
  427.      is entered on the Files menu.  You will be prompted to enter the name
  428.      of the file for transmission.  Include the drive and path if necessary.
  429.      Characters will begin transmission immediately and are displayed in the
  430.      transmit window.  Tranmsission can be terminated by pressing <ESC>.
  431.                                    Chapter 7
  432.  
  433.                                  Receive Buffer
  434.  
  435.      7.1  The receive buffer in TNC consists of 800 lines of 80  characters
  436.      each.  The receive window only shows the last several lines  in the
  437.      buffer.  Access to the entire receive buffer can be made by pressing
  438.      the Page-Up key or via the Files pull down menu.  The receive window
  439.      will  then  show the  receive  buffer beginning with the first line of
  440.      text  received.  Movement  through the buffer is made with the up and
  441.      down arrow  keys.  When   you  are  finished  press  <ESC>  to  return
  442.      to the normal transmit/receive screen.
  443.  
  444.      7.2  Saving the Receive Buffer - Access the save receive buffer function
  445.      on the Files pull down menu.  You will be prompted for a filename in
  446.      which to save the buffer.  The default is TNCTERM.BFR.
  447.                                    Chapter 8
  448.  
  449.                                  Data Base Use
  450.  
  451.      8.1  CWTERM uses and maintains three distinct data base files:
  452.  
  453.           DEFAULT NAME             USE
  454.  
  455.           LOGBOOK.DB     ISAM database file provides full log  keep-
  456.                          ing functions using a pop up menu.
  457.  
  458.           HAMGRAM.DBF    DBASE-III  compatible file containing  a  complete
  459.                          message generation and storage system.
  460.  
  461.           COUNTRY.LST    ASCII text file containing cross reference data of
  462.                          Prefix  to  Country.  Much faster than  using  the
  463.                          callsign book.
  464.  
  465.      8.2  LOG BOOK DATA FILE
  466.  
  467.      LOGBOOK.DB  is the default log book file.  You may alter the log  name
  468.      in the CWTERM.CFG configuration file.  This file is a ISAM database with
  469.      the following field definitions:
  470.  
  471.           FIELD NAME     TYPE      SIZE
  472.           DATE           DATE      8
  473.           TIME           CHAR      4
  474.           CALLSIGN       CHAR      15
  475.           RSTIN          CHAR      3
  476.           RSTOUT         CHAR      3
  477.           FREQ           NUMBER    8:4
  478.           MODE           CHAR      3
  479.           COMMENT        CHAR      29
  480.           QSLSENT        DATE      8
  481.           QSLRCVD        DATE      8
  482.  
  483.      8.2.1   LOGBOOK INDEX FILES - A single composite index file is maintain-
  484.      ed.  Both a DATE-TIME and CALLSIGN index are contained in this single
  485.      IDX file.
  486.  
  487.      8.2.2   Accessing the Logbook Data  -  The logging function is accessed
  488.      on the Log/NTS pull down menu or by pressing <alt>L. The following form
  489.      will overwrite the lowest lines of the screen.
  490.  
  491.   Date  │Time│  Callsign     │IN │OUT│ Freq   │MOD│ Comments       │RecNbr
  492. ────────┼────┼───────────────┼───┼───┼────────┼───┼────────────────┴────────────
  493.         │    │               │   │   │        │   │
  494. ────────┴────┴───────────────┴───┴───┴────────┴───┴─────────────────────────────
  495.     Add Bottom Delete Edit Find Index Next QSL Prev Top  eXit       [DATETIME]
  496.  
  497.      8.2.3  A new database will always show a RecNbr of 0 and blank fields
  498.      with the exception of Freq which will be 0.0000. Each function is invoked
  499.      by the first capital letter in the command word.  To record a logbook
  500.      entry use the Add function.  To modify an existing entry use the Edit
  501.      function.  When done either Adding or Modifying an entry return to the
  502.      command mode by pressing ESC to discard the changes or ctl_END to save
  503.      them to the database.  For additions to the database the Date and Time
  504.      will be entered from the system date-time corrected to GMT in accordance
  505.      with the environment variable TIMEZONE.
  506.  
  507.           IMPORTANT!!  ESC     discards the ADD or EDIT record
  508.                        ctl_END saves the record to the database.
  509.  
  510.      8.2.4  Pressing <I> for index will toggle the index between callsign
  511.      and date-time.  The date-time is the default index and the last entry
  512.      in the log book will be the one shown on initial entry.
  513.  
  514.      8.2.5  The <F>ind function performs the search based on the callsign
  515.      index.  I usually use this to find a previously worked callsign.
  516.      My log now has over 2000 entries covering a period of three years.
  517.      Finding a previously worked station is instantaneous!  The find may
  518.      be for an entire callsign or a partial.  For example:  entering W4
  519.      for the search string will put you at the first W4 callsign in the
  520.      logbook.  If a W4xxx entry does not exist, then the next record in order
  521.      after W4 will be displayed.
  522.  
  523.      8.2.6  <D>elete a record opens a dialog box for confirmation of the
  524.      delete request.  A delete record in an ISAM database is permanent!
  525.      The database and both index files will be modified to reflect the
  526.      removal of all 'deleted' records.
  527.  
  528.      8.2.7  Return to the calling program (TNC or COMMAND.COM) BY pressing
  529.      X for eXit.
  530.  
  531.      8.2.8  Separate LOGBOOK maintenance.  The program LOGBOOK.EXE can be
  532.      executed from the DOS command line.  Multiple logbooks can be maintained
  533.      and are accessed by specifying them on the command line extension:
  534.  
  535.           C:\HAM\LOGBOOK LOGBOOK  to access the CWTERM logbook
  536.           C:\HAM\LOGBOK CONTEST   to access the logbook named CONTEST
  537.  
  538.      8.3  NTS MESSAGE DATA FILE
  539.  
  540.      8.3.1 CWTERM maintains a data base of NTS messages which have been
  541.      transmitted.  These messages are in a DBASE-III compatible file with
  542.      the following data dictionary:
  543.  
  544.           DATA FIELD     TYPE      SIZE
  545.  
  546.           MSG_NBR        C         4
  547.           PRECEDENCE     C         1
  548.           HANDLING       C         1
  549.           HANDL_EXT      C         5
  550.           STATION        C         10
  551.           ORIGIN         C         15
  552.           FILE_TIME      C         4
  553.           FILE_MONTH     C         3
  554.           FILE_DAY       C         2
  555.           ADDRESSEE      C         25
  556.           ADDR1          C         25
  557.           ADDR2          C         25
  558.           CITY           C         25
  559.           STATE          C         2
  560.           ZIP            C         5
  561.           PHONE          C         13
  562.           TEXT_1         C         65
  563.           TEXT_2         C         65
  564.           TEXT_3         C         65
  565.           TEXT_4         C         65
  566.           TEXT_6         C         65
  567.           SIGN           C         25
  568.           SIGN_ADR1      C         25
  569.           SIGN_ADR2      C         25
  570.           SIGN_CITY      C         25
  571.           SIGN_ST        C         2
  572.           SIGN_ZIP       C         5
  573.           SIGN_PHN       C         13
  574.  
  575.      8.3.1  NTS Data Base Access - You access the NTS data base via the Log/NTS
  576.      menu. The transmit/receive screen will be replaced with a data entry form
  577.      which relates directly to the NTS message format.  The last message sent
  578.      (or a blank message for a new data base) will be in the fields.
  579.  
  580.      8.3.2 Data entry and movement through the data base is very similar to
  581.      making log book entries.  The main difference is that prompts and
  582.      selectable data entries are provided.  The casual preparation of an
  583.      NTS message does not require much of a learning curve.  The word count
  584.      is performed automatically.
  585.  
  586.      8.3.3   Data Entry Format:
  587.  
  588.          ┌─┤ 1 of  1 ├──┤HAMGRAM.DBF├─┤04/14/90├───────────────────────────┐
  589.          │ Nbr  P   Handling Inst  OrigSta  Place of Origin  Time Mon Day  │
  590.          ├─────────────────────────────────────────────────────────────────┤
  591.          │            HX                                                   │
  592.          ├─────────────────────────────────────────────────────────────────┤
  593.          │    To:                             Phone #                      │
  594.          │                                                                 │
  595.          │                                                                 │
  596.          │                                                                 │
  597.          ├─────────────────────────────────────────────────────────────────┤
  598.          │                                                                 │
  599.          │                                                                 │
  600.          │                                                                 │
  601.          │                                                                 │
  602.          │                                                                 │
  603.          ├─────────────────────────────────────────────────────────────────┤
  604.          │   From:                            Phone #                      │
  605.          │                                                                 │
  606.          │                                          ┌──────────────────────┤
  607.          │                                          │Word Count :          │
  608.          └──────────────────────────────────────────┴──────────────────────┘
  609.       N)ext P)rev T)op b(O)t G)o S)rch E)dit A)dd D)el B)row Pa(C)k W)rite Q)uit
  610.                                   <F1> for HELP
  611.  
  612.  
  613.      8.3.4  Writing the message to an ASCII file.  Pressing the <W> select
  614.      key will write the message in NTS format to a file name MSGnnnnn where
  615.      nnnnn is the assigned message number in the data entry form.
  616.  
  617.      8.3.5  Return to the transmit receive screen by pressing <Q> for quit.
  618.  
  619.      8.3.6  The file MSGnnnnn may now be sent as a plain text file trans-
  620.      mission.
  621.  
  622.      8.4 COUNTRY
  623.  
  624.      8.4.1 COUNTRY.EXE is a fast retrieval program for locating countries
  625.      when the callsign prefix is known.
  626.  
  627.      8.4.1 The file COUNTRY.LST is an ASCII file with the following format:
  628.  
  629.           ;Prefix Country/State/City      │sDD.MM│sDDD.MM
  630.           ;{Local}Cape May NJ             │ 38.57│  74.50
  631.           A2      BOTSWANA                │-22.00│ -24.00
  632.           A3      TONGA IS                │-20.00│ 175.00
  633.           A4X     OMAN                    │ 22.00│ -58.00
  634.           A5      BHUTAN                  │ 27.30│ -90.06
  635.  
  636.      Comment and special data lines begin with a semicolon.  The program
  637.      will default to computation of distance in nautical miles.  To change
  638.      to another standard delete the appropriate leading semi-colon from
  639.      the appropriate one of the lines which specify statue miles or kilo-
  640.      meters:
  641.  
  642.           ;;{Earth major axis st.miles     │ 3906.5
  643.           ;;{Earth major axis in kilometrs}│ 6387.388
  644.  
  645.      Each line of data must conform to the specified format.
  646.  
  647.           Prefix Country/State/City      │sDD.MM│sDDD.MM
  648.  
  649.      Your own latitude and longitude is specified on the ";local" line as
  650.      shown above.
  651.  
  652.      The entry for Cape May NJ, the authors QTH is:
  653.  
  654.      ;{Local}Cape May NJ             │ 38.57│  74.50
  655.  
  656.      The entry for Cedar Rapids would be:
  657.  
  658.      ;{Local}IOWA, CEDAR RAPIDS      │ 41.58│  91.40
  659.  
  660.      8.4.2  Accessing Prefix/Country list - Select Countries from the
  661.      Accessory pull down menu to call up the COUNTRY.EXE program.  You may
  662.      also access this program from the COMMAND.COM prompt.
  663.  
  664.      8.4.3  Quick location of a prefix can be obtained by pressing the
  665.      first letter of the prefix.
  666.  
  667.      8.4.4 Search by name of country is obtained by pressing CONTROL-S.
  668.      This opens a request window for the search string.  The search string
  669.      is not case sensitive, for example INDIA, india, and India will all
  670.      locate the same entry.  The light bar will be placed on the first
  671.      entry found containing that string, or left in place if not found.
  672.  
  673.      8.4.5 The file can be maintained using a non-document editor.  Be
  674.      certain to observe the limitation of line size and format.  You
  675.      should also maintain the alpha numeric sort of entries.  Adding or
  676.      deleting lines will not effect the program operation.
  677.                                    Chapter 9
  678.  
  679.                             Capturing Incoming Text
  680.  
  681.      9.1  Two methods are available for capturing incoming text.  The
  682.      receive buffer may be saved to a text file as previously described.
  683.      The incoming text may also be sent to a file as it arrives.   This is
  684.      accomplished by pressing alt<C>.  The capture file is alwasy named
  685.      TNCTERM.LOG and will be in the default directory.
  686.  
  687.      9.2 Incoming text will continue to be sent to the file until the next
  688.      alt<C> is pressed.  The file will be closed.
  689.                                    Chapter 10
  690.  
  691.                             Modifying Program Defaults
  692.  
  693.      10.1  SCREEN COLORS
  694.  
  695.      10.1.1  Screen colors may be changed and saved to a default file called
  696.      TNCTERM.CLR.  The program will read and use this file is in the default
  697.      directory when the program is first executed.
  698.  
  699.      10.1.2  COLOR SELECTION SCREEN   The color selection screen is available
  700.      as a choice on the SetUp menu.  The function keys are used to change
  701.      the foreground and background colors of each screen area used by TCN.EXE.
  702.      The colors selected by any one function key will rotate continuously
  703.      through the available choices as the key is pressed.
  704.  
  705.      10.1.3  SAVING and LOADING a color file can be performed from the SetUp
  706.      menu.  The default file will be TNCTERM.CLR but can be any file name
  707.      of your choice.
  708.  
  709.      10.2 CW Speed
  710.  
  711.      10.2.1 Select cwWPM from the Setup menu.  Enter the desired WPM into
  712.      the prompt window.
  713.  
  714.      10.3 RTTY Baud
  715.  
  716.      10.3.1 Select Baud from the Setup menu.  Enter the desired baud into
  717.      the prompt window.
  718.  
  719.      10.4 Date/Time
  720.  
  721.      10.5 Selecting Date/Time from the Setup menu will cause the proper
  722.      transmission of the DAYTIME string to the terminal node controller.
  723.      You should be sure that your are at the cmd: prompt when selecting
  724.      this function.  This will force the terminal node controller to be
  725.      keeping the same date/time as the computer.
  726.                                    Chapter 11
  727.  
  728.                                 DOS Applications
  729.  
  730.      11.1  You may temporarily exit TNC by selecting Dos from the DosApp
  731.      menu.  The program will bring up a temporary COMMAND.COM from which
  732.      you can execute DOS commands or other programs.  You may be constrained
  733.      by the amount of memory available.  Try checking by using the MEM
  734.      command.  On a 286 laptop computer with 640 K RAM there is 397 K of
  735.      memory available at this temporary DOS prompt.  If you specify a
  736.      different COMSPEC file in your autoexec.bat be certain that it is
  737.      a full specification including drive and directory.  The program will
  738.      call up your specified command file if it is found.
  739.  
  740.           Return to TNC by entering 'EXIT' at the dos prompt.
  741.  
  742.      11.2  EDITOR  The editor specified in the TNCTERM.DEF file can be
  743.      invoked with a specified edit file by selecting Editor from the
  744.      DosApp menu.
  745.  
  746.      11.3  PROGRAM TERMINATION - The program can be terminated in two ways -
  747.      by selecting the eXit line on the DosApp menu, or by pressing the
  748.      <alt>X key.  In either case you will be required to enter a 'y', or
  749.      'Y' to confirm the termination.
  750.                                    Chapter 12
  751.  
  752.                                    TNCED Editor
  753.  
  754.      TNCED is a full screen editor that is distributed with a Word Star (tm)
  755.      compatible keyboard interface.  It is capable of editing multiple files
  756.      with a tiled window for each file.  The total size of all files and
  757.      temporary buffers cannot exceed the size of available memory.  A 640 K
  758.      computer under DOS 4.0 can handle a single file of approximately 400,000
  759.      characters.
  760.  
  761.      The program is invoked from the command line as:
  762.  
  763.          TNCED file1 (file2 file3 file4 ...)
  764.  
  765.      to open and edit multiple files.
  766.  
  767.      The program is less than 60K in size and therefore is a convenient
  768.      editor to use when invoked as a child process from another program.
  769.      This is the way it is used when called by CWTERM.
  770.  
  771.      The program is completely configurable by the install program:
  772.  
  773.           TNCEDINST.EXE.
  774.  
  775.      Keyboard primary and secondary control sequences can be changed to
  776.      suit the individual user (emulate NE or QED or any other editor of
  777.      your choice).  They can be modified for your individual taste.  As
  778.      distributed the primary control sequences are WordStar (tm) compat-
  779.      ible.
  780.  
  781.      GRAPHICS EDITING
  782.  
  783.      The editor can be put into a graphics mode by pressing either <F10>
  784.      or <alt G>.  You return to the text mode by pressing the same key.
  785.  
  786.      The top line of the screen will show the present graphics characters
  787.      available.  Press <G> a few times to observe the full set of graphics
  788.      characters available.  Pressing <A> toggles between automatic and manual
  789.      selection of cursor movement.  When the AUTO is shown on the top line the
  790.      direction will change each time a corner is inserted into the text.  Nor-
  791.      mal motion is clock-wise.  You can force the cursor movement to change
  792.      direction by pressing the <D>.
  793.  
  794.      The <SPACE>, cursor keys, HOME, END, PageUp, and PageDn all behave the
  795.      same as when in a text mode.  The <INSERT> key is disabled and the editor
  796.      will only perform in a type over mode.
  797.  
  798.      You insert graphic characters by the use of the numeric keypad.  For
  799.      example the following set of graphics corresponds directly to the numeric
  800.      keypad as:
  801.  
  802.               GRAPHICS        KEYPAD
  803.  
  804.               ┌   ┬   ┐     7   8   9
  805.  
  806.               ├   ┼   ┤     4   5   6
  807.  
  808.               └   ┴   ┘     1   2   3
  809.  
  810.                ─   │        0   .
  811.  
  812.      The distribution copy of TNCED is installed for B&W displays with a
  813.      standard set of control key sequences.
  814.  
  815.      The arrow keys are specified as Lft, Rgt, Up and Dn.
  816.  
  817.      The control key is specified by the carat (^).  For example the key
  818.      sequence control page up would be:
  819.  
  820.          <^PgUp>.
  821.  
  822.  
  823.      ┌──────────────────────────────────┬──────────────────┬─────────────────┐
  824.      │ STANDARD SET - CONTROL FUNCTION  │  PRIMARY         │  SECONDARY      │
  825.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  826.      │ Character left                   │  <Lft>           │  <^S>           │
  827.      │ Character right                  │  <Rgt>           │  <^D>           │
  828.      │ Word left                        │  <^Lft>          │  <^A>           │
  829.      │ Word right                       │  <^Rgt>          │  <^F>           │
  830.      │ Line up                          │  <Up>            │  <^E>           │
  831.      │ Line down                        │  <Dn>            │  <^X>           │
  832.      │ Scroll up                        │  <^W>            │                 │
  833.      │ Scroll down                      │  <^Z>            │                 │
  834.      │ Page down                        │  <PgDn>          │  <^C>           │
  835.      │ Page up                          │  <PgUp>          │  <^R>           │
  836.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  837.      │ Top of window                    │  <^PgUp>         │  <^Q><^R>       │
  838.      │ Bottom of window                 │  <^PgDn>         │  <^Q><^C>       │
  839.      │ Cursor to left side              │  <Home>          │  <^Q><^S>       │
  840.      │ Cursor to right side             │  <End>           │  <^Q><^D>       │
  841.      │ Top of screen                    │  <^Home>         │  <^Q><^E>       │
  842.      │ Bottom of screen                 │  <^End>          │  <^Q><^X>       │
  843.      │ Go to line                       │  <^J><^L>        │  <alt N>        │
  844.      │ Go to column                     │  <^J><^C>        │                 │
  845.      │ Previous cursor position         │  <^Q><^P>        │                 │
  846.      └──────────────────────────────────┴──────────────────┴─────────────────┘
  847.  
  848.  
  849.      ┌──────────────────────────────────┬──────────────────┬─────────────────┐
  850.      │ STANDARD SET - CONTROL FUNCTION  │  PRIMARY         │  SECONDARY      │
  851.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  852.      │ Abort Command                    │  <^U>            │                 │
  853.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  854.      │ Undo last deletion               │  <^Q><^U>        │  <alt U>        │
  855.      │ Restore line                     │  <^Q><^L>        │                 │
  856.      │ Tab                              │  <^I>            │                 │
  857.      │ Insert control char              │  <^P> char       │                 │
  858.      │ New line                         │  <^M>            │                 │
  859.      │ Insert line                      │  <^N>            │                 │
  860.      │ Delete current character         │  <Del>           │  <^G>           │
  861.      │ Delete left character            │  <^H>            │  <^Bks>         │
  862.      │ Delete right word                │  <^T>            │                 │
  863.      │ Delete line right                │  <^Q><^Y>        │                 │
  864.      │ Delete line                      │  <^Y>            │                 │
  865.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  866.      │ Find pattern                     │  <^Q><^F>        │  <alt F>        │
  867.      │ Find and replace                 │  <^Q><^A>        │  <alt R>        │
  868.      │ Find next                        │  <^L>            │                 │
  869.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  870.      │ Graphics toggle                  │  <F10>           │  <alt G>        │
  871.      └──────────────────────────────────┴──────────────────┴─────────────────┘
  872.  
  873.  
  874.      ┌──────────────────────────────────┬──────────────────┬─────────────────┐
  875.      │ STANDARD SET - CONTROL FUNCTION  │  PRIMARY         │  SECONDARY      │
  876.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  877.      │ Log drive/path                   │  <^J><^D>        │                 │
  878.      │ Show TNCED version               │  <^J><^V>        │                 │
  879.      │ Show available memory            │  <^J><^R>        │  <alt M>        │
  880.      │ Toggle inster mode               │  <^V>            │  <Ins>          │
  881.      │ Toggle autoindent mode           │  <^Q><^I>        │  <alt I>        │
  882.      │ Set undo limit                   │  <^J><^U>        │                 │
  883.      │ Set default extension            │  <^J><^E>        │                 │
  884.      └──────────────────────────────────┴──────────────────┴─────────────────┘
  885.  
  886.      ┌──────────────────────────────────┬──────────────────┬─────────────────┐
  887.      │ STANDARD SET - CONTROL FUNCTION  │  PRIMARY         │  SECONDARY      │
  888.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  889.      │ Abandon file                     │  <^K><^Q>        │  <alt Q>        │
  890.      │ Read file into window            │  <^K><^R>        │                 │
  891.      │ Save and continue edit           │  <^K><^S>        │                 │
  892.      │ Save to file                     │  <^K><^N>        │                 │
  893.      │ Save and exit to DOS             │  <^K><^X>        │  <alt X>        │
  894.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  895.      │ Add Window                       │  <^O><^A>        │  <alt W><alt W> │
  896.      │ Resize current window            │  <^O><^S>        │  <alt W><alt S> │
  897.      │ Next Window                      │  <^O><^N>        │  <alt W><alt N> │
  898.      │ Previous Window                  │  <^O><^P>        │  <alt W><alt P> │
  899.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  900.      │ Begin block                      │  <^K><^B>        │  <alt B><alt B> │
  901.      │ End block                        │  <^K><^K>        │  <alt B><alt E> │
  902.      │ Top of block                     │  <^Q><^B>        │                 │
  903.      │ Bottom of block                  │  <^Q><^K>        │                 │
  904.      │ Copy block                       │  <^K><^C>        │  <alt B><alt C> │
  905.      │ Move block                       │  <^K><^V>        │  <alt B><alt M> │
  906.      │ Delete block                     │  <^K><^Y>        │  <alt B><alt D> │
  907.      │ Toggle (hide) block display      │  <^K><^H>        │  <alt B><alt H> │
  908.      │ Mark curent word                 │  <^K><^T>        │                 │
  909.      │ Write block to file              │  <^K><^W>        │                 │
  910.      └──────────────────────────────────┴──────────────────┴─────────────────┘
  911.  
  912.  
  913.      ┌──────────────────────────────────┬──────────────────┬─────────────────┐
  914.      │ STANDARD SET - CONTROL FUNCTION  │  PRIMARY         │  SECONDARY      │
  915.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  916.      │ Set marker 0                     │  <^K>0           │                 │
  917.      │ Set marker 1                     │  <^K>1           │                 │
  918.      │ Set marker 2                     │  <^K>2           │                 │
  919.      │ Set marker 3                     │  <^K>3           │                 │
  920.      │ Set marker 4                     │  <^K>4           │                 │
  921.      │ Set marker 5                     │  <^K>5           │                 │
  922.      │ Set marker 6                     │  <^K>6           │                 │
  923.      │ Set marker 7                     │  <^K>7           │                 │
  924.      │ Set marker 8                     │  <^K>8           │                 │
  925.      │ Set marker 9                     │  <^K>9           │                 │
  926.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  927.      │ Hide/Unhide marker               │  <^K><^M>        │ <alt B><alt H>  │
  928.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  929.      │ Jump to marker 0                 │  <^Q>0           │                 │
  930.      │ Jump to marker 1                 │  <^Q>1           │                 │
  931.      │ Jump to marker 2                 │  <^Q>2           │                 │
  932.      │ Jump to marker 3                 │  <^Q>3           │                 │
  933.      │ Jump to marker 4                 │  <^Q>4           │                 │
  934.      │ Jump to marker 5                 │  <^Q>5           │                 │
  935.      │ Jump to marker 6                 │  <^Q>6           │                 │
  936.      │ Jump to marker 7                 │  <^Q>7           │                 │
  937.      │ Jump to marker 8                 │  <^Q>8           │                 │
  938.      │ Jump to marker 9                 │  <^Q>9           │                 │
  939.      └──────────────────────────────────┴──────────────────┴─────────────────┘
  940.